home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: The RISC OS Graphics CD / Acorn User: The RISC OS Graphics CD.iso / utilities / scrdumper / _scrdumper / _help next >
Encoding:
Text File  |  1997-07-16  |  4.1 KB  |  118 lines
  1.  !ScrDumper
  2.  purpose : save the screen off to the disk.
  3.  author  : © Stanislas Renan, 1997
  4.  version 0.08, 15/07/1997
  5.  
  6. What is ScreenDumper ?
  7. --------------------
  8. ScreenDumper is a small module that enables you to <<shoot>> an image
  9. of the screen to the disk. This image is the _real_ image displayed,
  10. even in non-multitasking games or demos (well, I hope so).
  11. This image is in RISC OS sprite format.
  12.  
  13. Use :
  14. ---
  15. Load the module by double-clicking on its icon, dragging it to the iconbar,
  16. starting it from the command line or an obey file, launching it with a
  17. module you've written especially for this, or whatever you want.
  18. Press simultaneously the [shift], [control] and [print screen] keys.
  19. The screen will be saved in a file of which prefix name is by default
  20.     "ADFS::4.$.ScreenD".
  21. If you want to change this name, define the variable ScreenDump$File to
  22. the desired value, by typing for example :
  23.     "set ScreenDump$File RAM::0.$.BreizhIzel".
  24.  
  25. This name will evolve each time you dump the screen. Actually, it is
  26.     "<ScreenDump$File>n"
  27. where n is a number. All but file name are concatened with this number.
  28. So we'll get, BreizhIzel0, BreizhIzel1, BreizhIzel2, ...
  29.  
  30. Every time you restart the module, the default name is restored and the
  31. number set to zero.
  32.  
  33. If the file cannot be saved, a beep is generated.
  34.  
  35. Short history :
  36. -------------
  37.  version 0.08, 15/07/1997
  38.  -claims the keyboard vector frequently to avoid applications to steal it.
  39.  
  40.  version 0.07, 23/02/1997 :
  41.  -beep when an error occurs.
  42.  -tidied a bit the code.
  43.  
  44.  version 0.06, 19/02/1997 :
  45.  -default name changed to ADFS::4.$.ScreenD.
  46.  -multiple file option : ScreenD0, ScreenD1, ScreenD2...
  47.  
  48.  version 0.04, 17/02/1997 :
  49.  -reinitialision of the dump method on screen mode changing.
  50.  -finalisation of the OS_Word22 dump method (case vdu<>hard).
  51.  
  52.  version 0.03, 16/02/1997 :
  53.  -removed 'VDU graphic window not being the entire screen' bug that caused
  54.   sometimes only a portion (say a window) of the screen to be dumped.
  55.  
  56.  version 0.02, 15/02/1997 :
  57.  -it snaps all types of game/demo screens! (thanks to F. Elisei).
  58.  
  59.  version 0.01, 02/02/1997 :
  60.  -the file saved is contained in the variable <ScreenDump$File>
  61.  -the file by default is ADFS::4.$.tmp.ScreenFile
  62.  -it works even in non multitasking environment (so it can shoot demo scr.).
  63.  
  64. To do :
  65. -----
  66.  -tidy the vdu handling code (align the buffer if possible).
  67.  
  68. Legal things :
  69. ------------
  70. ScreenDumper is copyright (c) Stanislas Renan.
  71. ScreenDumper is freeware, this means that you can copy and give it freely
  72. provided you charge nothing (say, money) for this, and this file and the
  73. module remain unaltered and not separated.
  74.  
  75. ScreenDumper is billGate$FuckWare. You have to promote RISC OS, Galileo,
  76. ARM processors and Acorn machines to use it more that 7 days. If you fail
  77. in doing so, you must erase ScreenDumper from its medium.
  78.  
  79. ScreenDumper is PostCardWare. Please write me at the address below. Yes, really
  80. do it.
  81.  
  82. ScreenDumper is provided "as is", I make no warranty, whether express or
  83. implied, to its fitness for any particular purpose. In no circumstances will I
  84. be liable for any damage, loss of profits, goodwill or for any indirect or
  85. consequential loss arising out of your use of ScreenDumper, even if I have been
  86. advised of the possibility of such loss.
  87. This is a hidden line.
  88.  
  89. Contacting me :
  90. -------------
  91. *** Do not use E-Mail any more, sorry ***
  92. By E-mail : renan@aime.insa-tlse.fr
  93. By S-mail : Stanislas Renan
  94.         "Le Colombier"
  95.         22700 Perros-Guirec
  96.         France
  97.  
  98. Please feel free to contact me for suggestions or bug reports. Indicate the
  99. machine type you're using, its configuration, the environment of the dump that
  100. eventually failed (WIMP, game, demo...), the storage medium, etc.
  101. Please be precise, redundant, verbose, etc.
  102.  
  103. Getting ScreenDumper
  104. --------------------
  105. ScreenDumper is available at my WEB site :
  106. http://www.lookup.com/Homepages/85035/
  107.  
  108. I don't know how long this site will be valid. If it's long enough, I will
  109. update it to put my new E-mail address...when -and if- I get one!
  110.  
  111. Greetings :
  112. ---------
  113. Thanks to Frederic Elisei whose help has built this module more than me.
  114.  
  115. Apologies :
  116. ---------
  117. For my lame english.
  118.